home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libavc1394-0 / README < prev    next >
Text File  |  2006-04-13  |  3KB  |  62 lines
  1.  
  2.                    libavc1394
  3.                    ==========
  4.  
  5. 1. About libavc1394
  6.  
  7.     libavc1394 is a programming interface to the AV/C specification from
  8. the 1394 Trade Assocation. AV/C stands for Audio/Video Control.  Currently,
  9. applications use the library to control the tape transport mechansim on DV
  10. camcorders. However, there are many devices and functions of devices that
  11. can be controlled via AV/C. Eventually, the library will be expanded to
  12. implement more of the specification and to provide high level interfaces
  13. to various devices.
  14.  
  15.     librom1394 provides the ability to read the Configuration ROM
  16. on devices. It also permits the manipulation of ConfigROM images
  17. for the Linux 1394 host when used in conjunction with new libraw1394
  18. functionality to load and save config rom images. Configuration ROM is 
  19. addressed in a number of standards and specifications that build upon 
  20. the foundational standard IEEE P1212. At this time, it is only possible
  21. to update the rom directories by changing the root directory, updating
  22. the existing textual leaves of the root, and adding unit directories
  23. with simple ASCII textual leaves. It is not yet possible to remove unit
  24. directories or handle fancy stuff like icon decriptors.
  25.  
  26. 2. Usage Information
  27.  
  28.     The library comes with a console utility called dvcont that lets you
  29. send commands to the tape mechanism on your DV camcorder with IEEE-1394.
  30. There is a man page for it, so after installation 'man dvcont' for more
  31. information on how to use it. There is also a utility named motdctcmd to
  32. control Motorola DCT series settop boxes--e.g., change the channel.
  33.  
  34. 3. Copyleft
  35.  
  36.     libavc1394 itself is licensed under the Lesser General Public License
  37. (short LGPL, see file COPYING in the source distribution).  Other files in
  38. the source archives not belonging to but being part of the build procedure of
  39. libavc1394 are under their own licenses, as stated at the top of the individual
  40. files.
  41.  
  42. 4. API documentation
  43.  
  44.     There is currently no external document describing the library
  45. functions, but you can find documentation for all functions in the header file
  46. avc1394.h or avc1394_vcr.h.  avc1394_vcr.h is a very high level interface
  47. specific to the VCR AV/C subunit.  It implements the most common functions
  48. that an application needs to control the tape transport meachnism on a DV
  49. camcorder.  Both test/avc1394_vcr.c and test/dvcont.c are the best examples of
  50. how to use the libavc1394 interfaces. There are also examples in the test 
  51. directory for librom1394.
  52.  
  53. 5. Maintainer
  54.     Maintainer of libavc1394 is currently Dan Dennedy.  Send suggestions,
  55. bug reports and fixes to dan@dennedy.org.  See the file AUTHORS
  56. for a complete list of contributors to libavc1394.
  57.  
  58.     You can get updates through this project's homepage on SourceForge, see
  59. http://sourceforge.net/projects/libavc1394 for more information.  You can
  60. also submit bugs through this page.
  61.  
  62.